Connexions

Cette section vous aide à configurer les connexions requises pour accéder aux API à partir des services qui utilisent des connexions.

Pour configurer une telle connexion, commencez par créer une connexion dans Integration Service. Les connexions que vous créez dans Integration Service sont accessibles dans la même organisation et locataire que votre automatisation codée dans laquelle vous travaillez. Vous pouvez utiliser l'objet connections pour accéder aux connexions que vous avez précédemment créées dans Integration Service, puis accéder aux API correspondantes.

Une fois que vous avez terminé l’automatisation et que vous l’avez publiée dans Orchestrator, vous pouvez remplacer les paramètres de connexion initiaux que vous avez configurés dans le code.

Prérequis

Créez une connexion dans Integration Service :

1. Accédez à Integration Service et accédez à Connexions ( Connections).
2. Sélectionnez Ajouter une connexion et créez une connexion pour l’une des applications suivantes :
   • Microsoft OneDrive et SharePoint
   • Microsoft Outlook 365

Étapes

1. Open an existing coded automation from the same organization, and tenant where you initially created your connection.
2. Dans le corps Execute() , tapez connections, puis appuyez sur Ctrl + Espace pour voir les connexions disponibles.
   En fonction de l’application pour laquelle vous avez précédemment créé connection, vous pouvez choisir l’un des types de connexion suivants :
   • Office365
3. Further configure your connection by adding the Orchestrator folder name and the desired connection address, separated by underlines.
   Par exemple, une connexion OneDrive pour le dossier Mon espace de travail (My Workspace) dans Orchestrator et pour l'adresse [e-mail] seraient écrites en code sous la forme : connections.OneDrive.My_Workspace_john_doe_company_com.

   Recommandation

   We recommend you to create your connections in one step to avoid potential errors. We also recommend you to create a variable for the connection. This way, if changes occur in Integration Service, you'll avoid updating every instance of the connection throughout your automation. Use the following approach:

   var myOneDriveConnection = connections.OneDrive.My_Workspace_john_doe_company_com;

   Avoid creating your connections in two separate steps like:

   var myOneDriveConnection = connections.OneDrive;
   conn.My_Workspace_john_doe_company_com;

4. Once you've established the connection, you can access the relevant APIs specific to a service through that connection.
   Par exemple, si vous avez configuré une connexion OneDrive comme suit : var myOneDriveConnection = connections.OneDrive.My_Workspace_john_doe_company.com, vous pouvez utiliser l'API du service à l'aide de myOneDriveConnection.

Remplacer la connexion dans Orchestrator

1. Publiez à nouveau le projet dans Orchestrator.
2. Go to the Orchestrator feed where you've published the project.
3. Go to the published process and select Edit.
4. Dans Configuration du processus, choisissez l’automatisation codée contenant votre connexion configurée en tant que point d’entrée.
5. In Package Requirements, find and select the corresponding connection type for your coded automation.

   Be careful to select the connection type for your coded automation, as connections for XAML files within your project also appear in the list.

6. Identify and select the account address you plan to associate with the connection when it runs.